Microsoft Technologies HTTPClient ব্যবহার করে API Call করা গাইড ও নোট

HttpClient হলো .NET-এ একটি ক্লাস, যা HTTP রিকোয়েস্ট করতে এবং HTTP রেসপন্স গ্রহণ করতে ব্যবহৃত হয়। এটি APIs থেকে ডেটা ফেচ করার জন্য একটি জনপ্রিয় টুল। এই টিউটোরিয়ালে আমরা দেখবো কিভাবে HttpClient ব্যবহার করে API Call করা যায় এবং ডেটা সংগ্রহ করা যায়।

HttpClient ব্যবহার করার ধাপ

1. HttpClient ইনস্টল এবং ব্যবহার

• .NET Core বা .NET Framework-এ HttpClient ব্যবহারের জন্য কোন আলাদা প্যাকেজ ইনস্টল করার প্রয়োজন নেই, এটি System.Net.Http নেমস্পেসে অন্তর্ভুক্ত থাকে।

2. API Call করতে HttpClient ব্যবহার করা

একটি API থেকে ডেটা ফেচ করার জন্য HttpClient ক্লাস ব্যবহার করা হয়। GetAsync, PostAsync, PutAsync, DeleteAsync ইত্যাদি মেথডগুলি API রিকোয়েস্ট পাঠাতে ব্যবহার করা হয়।

উদাহরণ ১: GET রিকোয়েস্ট ব্যবহার করে API থেকে ডেটা ফেচ করা

এটি একটি সাধারণ GET API কল, যেখানে একটি রেস্টফুল API থেকে ডেটা ফেচ করা হয়।

Step 1: HttpClient ইনস্ট্যান্স তৈরি করুন

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // HttpClient ইনস্ট্যান্স তৈরি
        HttpClient client = new HttpClient();

        // API URL
        string apiUrl = "https://jsonplaceholder.typicode.com/posts";

        // GET রিকোয়েস্ট পাঠানো
        HttpResponseMessage response = await client.GetAsync(apiUrl);

        // রেসপন্স চেক করা
        if (response.IsSuccessStatusCode)
        {
            // রেসপন্স কনটেন্ট পড়া
            string data = await response.Content.ReadAsStringAsync();
            Console.WriteLine(data);
        }
        else
        {
            Console.WriteLine("Error: " + response.StatusCode);
        }
    }
}

ব্যাখ্যা:

• HttpClient: এটি HTTP রিকোয়েস্ট তৈরি এবং পাঠানোর জন্য ব্যবহৃত হয়।
• GetAsync: এটি একটি GET রিকোয়েস্ট পাঠায় এবং রেসপন্স গ্রহণ করে।
• ReadAsStringAsync: রেসপন্সের কন্টেন্টকে স্ট্রিং আকারে গ্রহণ করা হয়।

উদাহরণ ২: POST রিকোয়েস্ট ব্যবহার করে API Call করা

এখানে POST রিকোয়েস্ট ব্যবহার করে ডেটা API তে পাঠানো হবে।

Step 1: POST API কলের উদাহরণ

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // HttpClient ইনস্ট্যান্স তৈরি
        HttpClient client = new HttpClient();

        // API URL
        string apiUrl = "https://jsonplaceholder.typicode.com/posts";

        // পোস্ট ডেটা তৈরি
        var postData = new StringContent("{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}", Encoding.UTF8, "application/json");

        // POST রিকোয়েস্ট পাঠানো
        HttpResponseMessage response = await client.PostAsync(apiUrl, postData);

        // রেসপন্স চেক করা
        if (response.IsSuccessStatusCode)
        {
            // রেসপন্স কনটেন্ট পড়া
            string data = await response.Content.ReadAsStringAsync();
            Console.WriteLine("Response Data: " + data);
        }
        else
        {
            Console.WriteLine("Error: " + response.StatusCode);
        }
    }
}

ব্যাখ্যা:

• StringContent: এটি POST রিকোয়েস্টের কন্টেন্ট তৈরি করতে ব্যবহৃত হয়। এখানে JSON ডেটা পাঠানো হচ্ছে।
• PostAsync: এটি একটি POST রিকোয়েস্ট পাঠায় এবং রেসপন্স গ্রহণ করে।

উদাহরণ ৩: API Call এ Error Handling

API Call করার সময় বিভিন্ন ধরনের ত্রুটি ঘটতে পারে, যেমন নেটওয়ার্ক সমস্যা বা API সার্ভারের অপ্রত্যাশিত রেসপন্স। এর জন্য Error Handling গুরুত্বপূর্ণ।

Step 1: Error Handling এর সাথে API Call

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // HttpClient ইনস্ট্যান্স তৈরি
        HttpClient client = new HttpClient();

        // API URL
        string apiUrl = "https://jsonplaceholder.typicode.com/posts";

        try
        {
            // GET রিকোয়েস্ট পাঠানো
            HttpResponseMessage response = await client.GetAsync(apiUrl);

            // রেসপন্স চেক করা
            if (response.IsSuccessStatusCode)
            {
                // রেসপন্স কনটেন্ট পড়া
                string data = await response.Content.ReadAsStringAsync();
                Console.WriteLine(data);
            }
            else
            {
                Console.WriteLine("Error: " + response.StatusCode);
            }
        }
        catch (HttpRequestException e)
        {
            Console.WriteLine("Request error: " + e.Message);
        }
        catch (Exception e)
        {
            Console.WriteLine("General error: " + e.Message);
        }
    }
}

ব্যাখ্যা:

• try-catch ব্লক ব্যবহার করে ত্রুটি হ্যান্ডলিং করা হয়েছে।
• HttpRequestException: এই এক্সসেপশনটি HTTP রিকোয়েস্ট পাঠানোর সময় ত্রুটি ঘটলে ফেলে।
• General Exception: সাধারণ ত্রুটি হ্যান্ডলিং।

উদাহরণ ৪: Async/Await এবং HttpClient

এটি একটি async মেথড ব্যবহার করে API Call করা, যা অ্যাসিঙ্ক্রোনাস কলগুলোর জন্য উপযুক্ত।

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        await MakeApiCall();
    }

    static async Task MakeApiCall()
    {
        using (HttpClient client = new HttpClient())
        {
            string apiUrl = "https://jsonplaceholder.typicode.com/posts";
            HttpResponseMessage response = await client.GetAsync(apiUrl);

            if (response.IsSuccessStatusCode)
            {
                string data = await response.Content.ReadAsStringAsync();
                Console.WriteLine(data);
            }
            else
            {
                Console.WriteLine("Error: " + response.StatusCode);
            }
        }
    }
}

ব্যাখ্যা:

• Async/Await: অ্যাসিঙ্ক্রোনাস কোড লেখার জন্য ব্যবহার করা হয়, যা অ্যাপ্লিকেশনের UI থ্রেডকে ব্লক না করে ব্যাকগ্রাউন্ডে কাজ করতে সাহায্য করে।

Conclusion

HttpClient ব্যবহার করে API কল করা .NET অ্যাপ্লিকেশনগুলিতে খুবই সাধারণ এবং শক্তিশালী একটি পদ্ধতি। GET, POST, PUT, DELETE ইত্যাদি HTTP মেথডগুলি ব্যবহার করে API কল করা যায়। HttpClient-এর async/await ফিচার ব্যবহার করে অ্যাসিঙ্ক্রোনাস কল এবং ত্রুটি হ্যান্ডলিংও সহজে ইমপ্লিমেন্ট করা যায়, যা অ্যাপ্লিকেশনকে আরও দক্ষ এবং রেসপন্সিভ বানাতে সাহায্য করে।